home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / tclMotif-1.4 / README < prev    next >
Text File  |  1995-06-29  |  5KB  |  117 lines

  1. Welcome to...
  2. -------------
  3.  
  4.         A tcl binding to Motif
  5. Who by
  6. ------
  7. Jan Newmarch (jan@pandonia.canberra.edu.au).
  8.  
  9. Availability
  10. ------------
  11. The primary site for this is ftp.canberra.edu.au under
  12. /pub/motif/tclMotif/tclMotif.*.tar.z. It is also placed on X and tcl sites
  13. ftp.x.org and harbor.ecn.purdue.edu. From these sites it will be available
  14. on mirrors in lots of places. A binary version for Linux is also available
  15. from Linux sites such as sunsite and tsx-11.
  16.  
  17. What
  18. ----
  19. This package consists of a set of functions and a standalone interpreter "moat"
  20. that allow tcl programs to use the Motif set of widgets. A tcl file can be
  21. read by the standalone interpreter much as the Tk "wish" does. The difference
  22. is that instead of using the Tk library to create and manipulate Tk widgets,
  23. this system uses the Tm library to create and manipulate Motif widgets.
  24.  
  25. Major changes in version 1.4
  26. ----------------------------
  27.  
  28. -    lots of minor bug fixes.
  29. -    added methods: getSelectionValue, mrmFetchWidgetOverride,
  30.     addWMProtocolCallback, pending, windowID, displayInfo,
  31.     augmentTranslation, overrideTranslations, uninstallTranslations,
  32.     lowerWindow, raiseWindow, warpPointer, beep, setCommand
  33.     (many of these from Wolfgang Kechel - wolfgang@pr-wiesbaden.de).
  34. -    Modified addwidget syntax to make it easier to define related widgets
  35.     in a single file.
  36. -    INCOMPATABLE CHANGE: if a resource can't be found in a resource list
  37.     or in a constraint parent list, then we used to complain. Xt says to
  38.     ignore this, and Motif relies on this behaviour (e.g allowShellResize
  39.     in CreateFormDialog gets handed to both shell and form). So we don't
  40.     complain any more, and ignore unrecognised resources silently.
  41. -    INCOMPATABLE CHANGE: the string to XmString formatting converter is
  42.     now used for lists of strings, instead of XmStringCreateLToR.
  43. -    Added support for multiple displays so that a topLevelShell may be 
  44.     created on a new (or already open) display (Wolfgang Kechel - 
  45.     wolfgang@pr-wiesbaden.de)
  46. -    Lots of code cleanups (Wolfgang Kechel - wolfgang@pr-wiesbaden.de).
  47.  
  48. The full set of changes is given in the CHANGES file.
  49.  
  50.  
  51. Relation to Wafe
  52. ----------------
  53. The Wafe project also provides a binding of Xt widgets to tcl. Originally
  54. just the Athena widgets, it has been extended to other sets, and has a
  55. Motif binding in beta. 
  56. -    The language syntax differs. tclMotif is closer to Tk than Wafe is.
  57.     Wafe (and WKSH) use 
  58.         command object ...
  59.     syntax. Both Tk and tclMotif use
  60.         object command ...
  61. -    I use the standard Motif callbacks, Wafe has its own callback model.
  62. -    Wafe has more Xt support.
  63. -    The primary aim of wafe is as a tcl/Xt front-end to other languages.
  64.     My binding is just tcl to Motif, so I have been able to tune this
  65.     to the Motif model easier.
  66.  
  67. Status
  68. ------
  69. This is being actively maintained, as of March 1995. New versions 
  70. are released approx every 2-3 months, although this depends on many
  71. factors. Please report any bugs either in existing code, or omissions
  72. that reduce the way you would like to use tclMotif.
  73.  
  74. The changes over the releases are summarised in the file CHANGES
  75.  
  76. Requirements
  77. ------------
  78. This has been built using tcl7.3 and the Motif 1.2.1 development libraries.
  79. You need both. I have so far tested this stuff on a Sun O/S 4.1 and a 486
  80. running Linux. Earlier versions used tcl6.7, but this is no longer supported.
  81. It should compile using tcl7.0b3 onwards, and all versions of Motif 1.2.
  82. There is some Motif 1.1 support i.e. it will compile and most things will
  83. run, but some things such as getting resource values of scalars such as
  84. XmNarrowDirection won't.
  85.  
  86. The Motif 2.0 support is based on a beta version of Motif 2.0 that I had
  87. access to at one time. This will probably change when I get access to the
  88. production release.
  89.  
  90. Files
  91. -----
  92. The directory "src" contains the source files.
  93.  
  94. "doc" contains the man pages, a skimpy user manual, and a draft paper.
  95. It also contains a user manual in TeX format, contributed by 
  96. Jean-Dominique Gascuel. Unfortunately this describes version 1.0 and
  97. there have been some incompatable changes since then.
  98.  
  99. The "examples" directory contains a number of good programs that show how
  100. Tm works.
  101.  
  102. The "wtour" directory contains a widget-tour program based on Andrew Payne's
  103. wtour program for Tk.
  104.  
  105. The "tests" directory contains the regression test files for Tm. These cover
  106. many features of Tm, but are not designed for easy reading. The file "index"
  107. in  this directory shows what is tested.
  108.  
  109. The "programs" directory contains adhoc programs used in developing Tm. These
  110. are in no particular order, not documented. You may see some useful examples
  111. in here, but it is pot-luck. There is no guarantee that any particular one
  112. will work.
  113.  
  114. At the top level, INSTALL tells you how to build Tm and moat and COPYRIGHT
  115. tells who owns it and why.  CHANGES documents what has happened between
  116. versions.
  117.